package com.square.service.redis.provider.service;

import java.util.List;
import java.util.Map;
import java.util.Set;

/**
 * @author : 18.40
 * @date : 2020/4/5 19:18
 * @description : redis服务层
 */
public interface RedisService {

    /**
     * 指定缓存失效时间
     */
    boolean setExpire(String key, long time);

    /**
     * 根据key 获取过期时间
     */
    long getExpire(String key);

    /**
     * 判断key是否存在
     */
    boolean hasKey(String key);

    /**
     * 删除缓存
     */
    void delete(String... key);

    /**
     * 普通缓存获取
     */
    Object get(String key);

    /**
     * 普通缓存放入
     */
    boolean set(String key, Object value);

    /**
     * 普通缓存放入并设置时间
     */
    boolean set(String key, Object value, long time);

    /**
     * 递增
     */
    long increment(String key, long delta);

    /**
     * 递减
     */
    long decreasing(String key, long delta);

    /**
     * HashGet
     */
    Object getHashMap(String key, String item);

    /**
     * 获取hashKey对应的所有键值
     */
    Map<Object, Object> getHashMap(String key);

    /**
     * HashSet
     */
    boolean setHashMap(String key, Map<String, Object> map);

    /**
     * HashSet 并设置时间
     */
    boolean setHashMap(String key, Map<String, Object> map, long time);

    /**
     * 向一张hash表中放入数据,如果不存在将创建
     */
    boolean setHashMap(String key, String item, Object value);

    /**
     * 向一张hash表中放入数据,如果不存在将创建
     */
    boolean setHashMap(String key, String item, Object value, long time);

    /**
     * 删除hash表中的值
     */
    void deleteHashMap(String key, Object... item);

    /**
     * 判断hash表中是否有该项的值
     */
    boolean hasKeyForHashMap(String key, String item);

    /**
     * hash递增 如果不存在,就会创建一个 并把新增后的值返回
     */
    double incrementForHashMap(String key, String item, double by);

    /**
     * hash递减
     */
    double decreasingForHashMap(String key, String item, double by);

    /**
     * 根据key获取Set中的所有值
     */
    Set<Object> getSet(String key);

    /**
     * 根据value从一个set中查询,是否存在
     */
    boolean hasKeyForSet(String key, Object value);

    /**
     * 将数据放入set缓存
     */
    long setSet(String key, Object... values);

    /**
     * 将set数据放入缓存
     */
    long setSet(String key, long time, Object... values);

    /**
     * 获取set缓存的长度
     */
    long getSetSize(String key);

    /**
     * 移除值为value的
     */
    long removeSet(String key, Object... values);

    /**
     * 获取list缓存的内容
     */
    List<Object> getList(String key, long start, long end);

    /**
     * 获取list缓存的长度
     */
    long getListSize(String key);

    /**
     * 通过索引 获取list中的值
     */
    Object getListObjByIndex(String key, long index);

    /**
     * 将list放入缓存
     */
    boolean setList(String key, Object value);

    /**
     * 将list放入缓存
     */
    boolean setList(String key, Object value, long time);

    /**
     * 将list放入缓存
     */
    boolean setList(String key, List<Object> value);

    /**
     * 将list放入缓存
     */
    boolean setList(String key, List<Object> value, long time);

    /**
     * 根据索引修改list中的某条数据
     */
    boolean updateListObjByIndex(String key, long index, Object value);

    /**
     * 移除N个值为value
     */
    long removeList(String key, long count, Object value);

    /**
     * 添加一个元素, zset与set最大的区别就是每个元素都有一个score，因此有个排序的辅助功能;  zadd
     */
    boolean setZSet(String key, Object value, Double score);

    /**
     * 删除元素 zrem
     */
    void removeZSet(String key, String value);

    /**
     * 递增
     */
    Double incrementForZSet(String key, String value, double score);

    /**
     * 查询value对应的score   zscore
     */
    Double getZSetScore(String key, String value);

    /**
     * 判断value在zset中的排名  zrank
     */
    Long getZSetRank(String key, String value);

    /**
     * 返回集合的长度
     */
    Long getZSetSize(String key);

    /**
     * 查询集合中指定顺序的值， 0 -1 表示获取全部的集合内容  zrange
     */
    Set<Object> getZSetRange(String key, int start, int end);
}
